/status/system/interface/<intf_name>/channelPorts/<member_intf_name>/reason

</member_intf_name>

Use

Use to view the why the port is in its current state.

Parameters

intf_name: Name of port channel interface

member_intf_name: Name of interface that is a member of the port channel

Data Key

The data key contains one of the values in Data Values below.

Note: When the default key is set to true, it means the object is set to its default. In this case, the system works as follows:

  • On a PUT operation, the system ignores the data key. (Applicable only to /config nodes.)
  • On a GET operation, the response only contains “default”: True and does not contain the data key.
  • If the object has a base, it inherits its setting from its base.

See [Setting Objects to Their Default](https://docs.lineratesystems.com/087Rel ease_2.6/250REST_API_Reference_Guide/000Getting_Started_with_the_REST_API/300U nderstanding_the_REST_Hierarchy#Setting_Objects_to_Their_Default_(Default_Key) ).

Data Type

string

Data Values

Unset

The port channel’s mode has not been set or does not match the rest of the interfaces in the port channel.

Static

The port channel’s mode is set to “on.”

LACP

The port channel’s mode is set to “active,” which means it is using LACP.

Admin Status Up or Admin Status Down

The port channel’s admin status is set to online or offline.

Link Protocol Up or Link Protocol Down

The connection to the port channel is not working for some hardware reason (cable disconnected, failed interface, etc.).

Unknown

The system cannot determine the status of the port channel.

Default Data Value

“”

An object uses the default data value when one of the following is true:

  • For objects without bases–When the object’s default key is true.
  • For objects with bases–When the object’s default key is true, and when the default key is true for all of the object’s bases.

Request Methods

GET

Examples

GET

curl -b cookie.jar -k https://host-43:8443/lrs/api/v1.0/status/system/interfac e/name/channelPorts/name/reason

GET Response

{"httpResponseCode": 404,
 "internalResponseCode": 101,
 "message": "Request failed: Unable to retrieve data from controller\n  Path: /system/interface/name/channelPorts/name/reason\n  ResponseCode: 101 (Path not found)\n",
 "recurse": False,
 "requestPath": "/status/system/interface/name/channelPorts/name/reason"}
  1. /status/system/interface/<intf_name>/channelPorts/<member_intf_name>/reason</member_intf_name> 1. Parameters 2. Data Key
    1. Data Type
    2. Data Values
    3. Default Data Value 3. Request Methods 4. Related 5. Examples